home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / diskmags / 0022-3.564 / dmg-3418 / checkdis.out / multi_v1.dox next >
Text File  |  1986-02-05  |  14KB  |  332 lines
  1.  
  2.  
  3.              +----------------------------------------------------+
  4.              |                                                    |
  5.              | Instructions for 'Multi Depacker v1.0' by MUG U.K™ |
  6.              |                                                    |
  7.              |           Finished on 2nd December 1991            |
  8.              |                                                    |
  9.              +----------------------------------------------------+
  10.  
  11.  
  12.                         Released into the Public Domain
  13.                         -------------------------------
  14.  
  15.  
  16. Introduction
  17. ------------
  18.  
  19. This program was written as an aide to the myriads of demo-breakers,
  20. nosey hackers and interested people of all levels and skills to save them
  21. from using a disassembler to unpack and save out data and executable files
  22. that have been packed using a selection of the best available packers in
  23. the Public Domain.  There are other uses, including unpacking a program that
  24. you had previously packed with an outdated packer (eg. original file was
  25. packed with Automaion v2.4), and then repacking with the latest top-notch
  26. packer (eg. Atomic v3.3).  Thus this utility arose from the ashes of my
  27. 'Fire & Ice Depacker v4.0'.
  28.  
  29. I hadn't intended to start this until way into 1992, but seeing as I was
  30. feeling down (poll tax, phone bills & Christmas Shopping, but no money to
  31. pay for any of them !!), I started on this program.  A week later, the
  32. finished result was released !!
  33.  
  34.  
  35. Technical Stuff
  36. ---------------
  37.  
  38. The files required to be kept in the same folder are:-
  39.  
  40. MULTI_V1.PRG
  41. MULTI_V1.RSC
  42. MULTI_V1.DOX
  43.  
  44. Do not seperate these files or edit them.  You can archive them for bulletin
  45. boards if you so wish.  As usual, this program is Public Domain.  It is
  46. my copyright, but you can stock it within a Public Domain Library or on a
  47. bulletin board with my full consent.  Magazines that have Cover Disks mounts
  48. (ST Format/ST Uset et al), CANNOT publish this program with my consent and
  49. appropriate payment.
  50.  
  51. Also for the myriads of disk-based magazines who are published via Budgie, or
  52. via any other means (Ledger, Toxic etc.), you can include this program on
  53. your disks with my full consent.  Although I have most probably already sent
  54. it on to you on the day of release.  Other groups who make up utility disks
  55. can also include this program (so long as all the files are kept together)
  56. if they see fit.  After all, it is a very handy utility for most people
  57. to have in their collection, so why not SPREAD IT !!
  58.  
  59.  
  60. More Technical Info
  61. -------------------
  62.  
  63. This program will allow you to depack ANY file that has been packed with
  64. any of the following packers:-
  65.         
  66. Atomic v3.1             Atomic v3.3
  67.  
  68. Automation v2.3/2.4     Automation v2.51r       Automation v5.01
  69.  
  70. Ice Packer v1.13 (data ONLY at present)         Ice Packer v2.11
  71. Ice Packer v2.12        Ice Packer v2.2         Ice Packer v2.31
  72. Ice Packer v2.34        Ice Packer v2.40
  73.  
  74. Fire Packer v1.01 (data ONLY at present)        Fire Packer v2.01
  75.  
  76. JAM Packer v3.0 (LZH)   JAM Packer v4.0 (LZW & LZH)
  77.  
  78. Pompey Pirates v1.9a (data ONLY at present)
  79.  
  80.  
  81. Nineteen different packers, which makes a total of 35 different file
  82. types that can be loaded in, depacked and saved out again !!
  83.  
  84. When I say 'any file' - I mean ANY file, either executable or data files.
  85. The only (obvious) exceptions are where I have been unable to fully
  86. incorporate a depack option for the executable files generated by some
  87. packers, without having bombs and other crashes occuring !!
  88.  
  89.  
  90. I've Even Tested It !!
  91. ----------------------
  92.  
  93. I've tested this program on both data & executable files packed with the
  94. above packers.  The testing was done on a bog standard TOS v1.2, with 1
  95. Meg of RAM and a hard-drive.  I have included enough error-traps to stop
  96. the depacking of 1 Meg files on a 512K system etc.  The most common error
  97. on a 512K is that with the majority of the packers I am using, they depack
  98. from one address to another, therefore I require two buffers.  If the file
  99. to depack is 100K and the unpacked length is 250K, then you will be unable
  100. to unpack this file.  For the next update, I shall (probably) write a 
  101. .TTP version (without dialog boxes etc.) to enable the really BIG files to
  102. be depacked on any machine.
  103.  
  104. The majority of the packers recognised by this program were written by
  105. Axe of Delight/Superior.  Depacking the packed files was (and still is !!)
  106. a much needed feature missing from these otherwise excellent packers.  This
  107. is especially annoying if you had just packed your only copy of a much
  108. needed file !!
  109.  
  110. The other packers were added bit by bit over a period of a week, and halfway
  111. through that week, I scrapped all the text-printing and opted for a much
  112. easier to use 'GEM' front-end.  Depacking files is now much easier than in
  113. previous incarnations of this programs' predecessor - 'Fire & Ice Depacker',
  114. which was officially released on The Source Menu 79 (Hi! to the other
  115. comrades in this group:- Kalamazoo, Speed, Egon, JJF & IWWWTTI ????).
  116.  
  117.  
  118. Using The Program
  119. -----------------
  120.  
  121. Once loaded, you will first be presented with an introductory dialog box
  122. showing which version this program is and which packed files it can depack.
  123. Click on the button when you've read all of this (I know it is in the
  124. small font, but it's the only way I could fit in all on !).
  125.  
  126. The next dialog box is the main menu.  From here, you can have another
  127. look at the previous dialog box, depack files, see how much memory you've
  128. got left and finally quit back to the Desktop.
  129.  
  130. Seeing as this program is primarily a depacker, the major option to go
  131. for is the 'Depack And Save Files'.  Click on the button and you will be
  132. presented with a file-selector which wants the filename of a packed file.
  133. Clicking on 'Cancel' or selecting a non-existant file will result in an
  134. alert box telling you of your mistake, and an option to try for another
  135. file or returning to the main menu.
  136.  
  137. Once you've found a file that you know is packed, it will be loaded into
  138. memory and examined .....  After first checking whether the file is a
  139. program file or not, it will then check for the existance of the various
  140. packer headers (eg. 'LSD!', 'ICE!', 'FIRE', 'ATOM').
  141.  
  142. If any disk errors occur, you will will prompted by an alert box asking you
  143. to retry and get another file or cancel this operation and go back to the
  144. main menu.  If the selected file is NOT recognised, then you will returned
  145. back to the main menu (after an alert box has told you that your selected
  146. file was not recognised).
  147.  
  148. If the file is a packed file, a dialog box will appear with the following
  149. information on it:-
  150.  
  151.   i) Which packer was used
  152.  ii) Executable or data file
  153. iii) The length of the file (in disk-space terms)
  154.  iv) The length of the packed file (as the packer knew it as)
  155.   v) The length of the unpacked file (as it will be AFTER it is unpacked)
  156.  
  157. The reason for including both (iii) & (iv) on the screen, is that some files
  158. I found would be 20K in length, but the header would say it was only
  159. 18.5K in length !!!  One explanation is that some programs contain two sections
  160. contain two sections, hence the numbers displayed on the screen would be
  161. a bit odd.  An example of this is 'Digi Composer v1.0' by Istari.  It
  162. contains two programs, an intro and the actual tracker.  The intro is
  163. depacked first, then the tracker.
  164.  
  165. Another reason is that if you depack a program file, the file-length will
  166. differ from the actual length of the packed data because the program needs
  167. a depack routine to unpack itself, and relocate it to the original address !
  168. If you find that the lengths differ by around 1000 bytes on a program file,
  169. then you should be OK .......
  170.  
  171. There are two options on this dialog box, and they are pretty obvious to
  172. understand.  One will depack the present file, and the other will return
  173. you to the main menu.
  174.  
  175. If you are depacking a Atomic v3.1/v3.3 data file, you are given the option
  176. to choose which depack routine.  If you select the wrong one then this program
  177. will more than likely depack your file into complete garbage or even worse,
  178. it will bomb out !!  The reason is that the header (ATOM) is the same for
  179. either version of these packers and the depack routine is not compatible
  180. with the other version (unlike the Ice Packers !!).
  181.  
  182. Each depacker will flash a different colour, so as to differentiate between the
  183. different packers.  If you have a monochrome monitor, you will probably
  184. end up with a bad headache after depacking a lot of files !!  I suggest you
  185. don a pair of Bitmap Shades before depacking a lot of files (colour systems
  186. OR monochrome), unless you're into flashing colours ???
  187.  
  188. Another file-selector will appear asking for the depacked file.  You have
  189. the option of overwriting the program file (not very wise !!) if you
  190. require - or simply enter a new filename as it is up to you !!  After this
  191. operation, you will be returned to the main menu, where you can carry on
  192. depacking more files, or quit and take a peek at the newly unpacked files.
  193.  
  194. That's all there is to my little program.  It works with almost everything
  195. I've tried, with one or two exceptions - but I'll let you find them out
  196. for yourselves !!  If you have any really major hassles then drop me a line
  197. at the address down below (oo-er !!).
  198.  
  199.  
  200. End Bit:
  201. --------
  202.  
  203. Since I was testing this program heavily I noticed a few things with the
  204. various packers.  Here are some notes I made (bugs I discovered !!).
  205.  
  206. i) If you write (like I do) prodonimently in GFA BASIC v3.5/v3.6, and you
  207.    want to pack your program files.  DO NOT use Ice Packer v2.2-2.31 or
  208.    Fire Packer v2.01, as your program file will not work at all (two bombs).
  209.    You will have to use the Ice Packer v2.40 (ST News 6.2 edition).
  210.  
  211. ii) If you use the Automation v5.01 and pack a lot of data files, beware
  212.     of using it from a hard-drive !!  The problem is that your resultant
  213.     files are filled with $00 & $FF ONLY !!  Not even a header (AU5!) is
  214.     included.  This happens with the normal, buffer and chunk pack options
  215.     and I do not know exactly why his occurs.  My (bad) theory is that this
  216.     update does not like my (or anyone elses ?) hard-drive !!!  The error
  217.     does not occur when you run the program from a floppy, but only when
  218.     it is run from a hard-drive partition ??  Well, EGB, work that one out
  219.     if you can !!  I use the Supra Software v3.11 driving a Megafile 60, if
  220.     this is any use to you !!
  221.  
  222. iii) This is not an error, but a bit of a pain.  The Atomic packers will
  223.      not output a packed file that is of an odd length !!  No problem
  224.      to 99% of files, except when it's the NeoChrome Master which checks
  225.      its length for link-virus infection !!
  226.  
  227.  
  228. If you can help me (or if you are the author of the packer in question, please
  229. write to me with your next versions), then write to the address near the
  230. end of this document file.
  231.  
  232. DO NOT send ANY form of pirated software, as I am NOT interested.
  233.  
  234.  
  235. I would also like depack source code FOR the following packers:-
  236.  
  237. Automation v2.51+  - I need some explanatory Chunk Depacking source that I
  238.                      can call with registers set to source and destination
  239.                      addresses.
  240.  
  241. Power Packer v2.2a - Amiga packer used by several programmers on the ST !!
  242.                      I have the source as used by v3.0, but it doesn't
  243.                      work properly !!
  244.  
  245. YOUR packer/source - If it's any good that is !!
  246.  
  247.  
  248. The next version of this 'Multi-Depacker' will be released when I'm
  249. ready.  I have another 10 or so packers that I will be including, plus
  250. the 'no-frills' version that will come with it so that 512K owners can
  251. depack large files.
  252.  
  253. A quick message to JPM (author of Pompey Packer):-  I am still after some
  254. source to depack Thunder v1.0 & v1.1 ???  Please, please, please get in
  255. touch (you'll also benefit via FVK - interested ??).
  256.  
  257.  
  258. End Bit
  259. -------
  260.  
  261. Have fun depacking, hacking, poking about and generally being very nosey
  262. with other peoples (previously) packed files !!
  263.  
  264. If you really find this program useful, saves your life with packed programs
  265. not depacking on your version of TOS etc. etc., spare a thought for me, an
  266. low paid barman, toiling away at unsociable hours, then working on my many
  267. programs after work, way into the early hours of the morning, just so you
  268. can benefit .......... SEND ME SOME MONEY !!
  269.  
  270.  
  271. MUG U.K™ - 02/12/1991
  272.  
  273.  
  274.  
  275. Depacker Credits:
  276. -----------------
  277.  
  278. Depacker Program
  279. RSC Design
  280. Documents
  281. Coffee Drinking:                    MUG U.K™ - 29/11/1991
  282.  
  283. Background Music:                   Metallicas' new album "Metallica"
  284.                                     Extremes' "Pornograffitti"
  285.  
  286. Testing:                            Slasher Bog
  287.  
  288.  
  289.  
  290. Packers' Authors Credits:
  291. -------------------------
  292.  
  293. Atomic Packers v3.1 & v3.3:         ALTAIR of VMAX/MCS
  294.  
  295. Automation v2.3/2.4:                OZZ of LSD
  296. Automation v2.51:                   DACK of Automation
  297. Automation v5.01:                   EGB of SHiT
  298.  
  299. Fire/Ice Packers:                   Axe of Delight/Superior
  300.  
  301. JAM Packers v3.0 & v4.0:            Jek and Moose (JAM)
  302.  
  303. Pompey Packer v1.9a:                JPM
  304.  
  305.  
  306. Contact Address:
  307. ----------------
  308.  
  309. MUG U.K™
  310. c/o Broadsword Computers,
  311. 141 High Street
  312. Rhyl
  313. CLWYD
  314. LL18 1UF
  315.  
  316.  
  317. Any problems, queries, questions etc. should be sent to the above address,
  318. and don't even think of writing if you want pirated software !!  I get
  319. extremely FED UP with people who write to me wanting the addresses of the
  320. various pirate groups.   I DON'T KNOW THEM SO *ISS OFF !!!
  321.  
  322. I will keep all the disks & burn the letters from these idiots.  If you
  323. want a game that desperately, go out and buy it !!
  324.  
  325. One last thing, if you are a kind generous person who has got a spare bit
  326. of money lying idly about, don't send me a cheque made payable to 'MUG U.K'
  327. as I get strange looks from the staff at my building society !!  If you
  328. really must send a cheque, make it payable to 'Mike Mee' (stop sniggering at
  329. the back - I can't help my surname !!).
  330.  
  331.  
  332.